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A Mechanism for Converting Between 
Java Classes and XML 

Overview 

Java and XML (extensible Markup Language) technologies provide developers with the tools to 
write portable code and operate on portable data. Support for XML in the Java platform is 
increasing with the availability of standard APIs and parsers such as SAX and DOM (Document 
Object Model). While these APIs provide standard mechanisms for reading XML documents, they 
work at a relatively low level. Using DOM for example, developers must have a detailed 
understanding of how to use the API to navigate nodes, elements, attributes, and to extract textual 
content and then convert the text to useful program data types. This may be tedious, error prone, 
and requires the developer to work with classes outside the application domain. 

This paper describes a mechanism that allows developers to convert easily between Java and XML 
representations of data while working exclusively with classes from the application domain. With 
very little work, developers can add XML support for complex hierarchies of any user-defined 
class, Java primitives (int, float, boolean, etc.) and wrapper classes (Integer, Boolean, Float, etc.) as 
well as collections and arrays of such objects. 

A proposal by Sun Microsystems has been drafted that deals with this topic using a different 
approach (An XML Daia-Binding Facility for the Java Platform, Mark Reinhold, Core Java 
Platform Group, 30 July 1999 - see www.javasoft.com/xml). They propose a schema compiler that 
generates Java classes from an XML schema. The API proposed in this paper has the following 
advantages: 

• No schema compiler is required to generate new Java classes. 

• New or existing classes can be easily annotated to work with the API. 

• The developer has full control and flexibility over how the classes get mapped to XML. Two 
totally different class- implementations can work with the same XML representation in different 
ways. 

The following sections discuss how the API is used including the API class descriptions. 

An Example 

Data is described in XML in a hierarchical way by tagging elements. An XML document contains 
one Single element (the document element) that may contain any number of other elements. For 
example, an XML representation of a book store may be written as: 

<bookstore> 

<name>The Programmer's Book Score</name> 
<address> 

<screec>l Industrial Way</screet> 
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<city>Middletown</city> 
<state>NJ</scace» 
<zip>07701</zipp- 
</address:> 
■cbooks* 

<book reviewed="no">- 

<title>xml and Java</title> 

<author>Hiroshi Maruyama</author> 

<cost;>$4 9 . 00 < /cost > 
</book? 

<book reviewed="yes"> 

<title:>Java in a Nutshell</title> 
<author>Flannicfan< /author ;> 
<cost>$3 9 .00</ccst> 
<review> 

<reviewed3y>Joe</reviewedfiy> 
<rating>3 .5</rating> 
<:/review> 
<review> 

<revi ewedBy>Bob< /reviewedBy> 
<rating>9 . 5<r/rating> 
</review> 
</bock> 
< /books > 
</bookStore> 

The document contains a single element bookStore, which has sub-elements for name, address, and 
books. The 6<?o>b* element contains a collection oSbook elements. Elements may contain one or 
more "attributes " such as the reviewed attribute of book, used to indicate whether the book has been 
reviewed or not. Books that have been reviewed contain one or more review elements. 

This data can be modeled by a set of Java classes, such as: 

class Bookstore { 
String name ; 
Address address; 
Vector books; 
// ... public methods 

} 

class Address { 
String street ; 
String city; 
String state,- 
String zip; 
// ... public methods 

} 

class Book { 

String author; 
String citle,- 

float COSC; 

// ... public me: hods 



class ReviewedBook extends Book { 
vector reviews; 

void addReview (Review review); 

vector getReviewst) { return reviews; } 

} 
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The goal of the API is to let the developer construct the data using Java only, then somehow convert 
the classes to XML and later re-construct the contents of the Java classes from the XML file. For 
example: 

Bookstore bookstore = new Bookstore { *The Programmer's Book Store"); 
BookS tore. sec Address (new Address [ u l Maple Sc.", "Middletown" , "NJ") ); 

Book book = new Book ("Java in a Nutshell", "Flannigan" ) ; 
Book.setCost (49. Of) ; 
BookS co re. add (book) ; 

SaveToXmK books core, "books c ore .xml" ) ; // a hypothecical mechod 
// later, read the contents back to Java 

BcokScore bookScore = ReadFromXml ( -bookstore .xml" ) ; // a hypothetical mechod 
Collection books = bookstore - gecBooks () ; 

The next section describes an API that accomplishes this. 

XML to Java API 

The XmlReaderWriterlnterface 

In order to convert user-defined types to XML, such as BookStore, Address, Book, and Review in 
the above example, each must include some instructions about how to do the conversion. The API 
needs to know: 

• Which fields inside the Java object should be saved to XML? We may want the Java class to 
contain other fields that are used internally and should not get converted. 

• For each field that we want converted, what tag name should be used when generating the 
corresponding XML element. 

• When reading an XML file and constructing the java objects, what classes should be instantiated 
for each element? We want to be able to support different classes and different Java 
implementations using the same XML representation. 

The Java to XML API accomplishes this by defining the XmlReaderWriter interface. Any class that 
we wish to convert to XML or construct from an XML document must implement this interface. 
The interface is defined as follows: 

interface XmlReaderWriter { 

FieldDescripcion [] gecfieldDescriptions ( } ; 
void setAttribuces (Hashtable he) ; 
Hashcable gecAtcribuces { ) ; 

1 

The first method getFieldDescriptions is required. This allows the class to define how it should be 
converted. Typically, this will add just one line of code for all sub-elements contained by the class. 
The second two methods are optional, and are not used if the class does not use attributes as 
mentioned above. The FieldDescripcion class is described in the next section, but to illustrate it's 
use, the BookSwre class from the last example can add the following lines of code to implement it: 
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class BookScore { 

public FieldDescription [] getFieldDescriptions ( ) { 
return new FieldDescription [} { 

new FieldDescripcion ("name" , String .class , ^gecName", "setName" ) , 
new FieldDescription {"address" , Address . class , "get Address" , "setAddress") , 
new FieldDescription { "books" , Vector . class , "getBooks", "secBooks", 
Book, class, "book") , 

}; 

public void setAttributes (Hashtable ht) (;} // not used 

public void Hashtable getAttributes ( ) { return null; } // not used 

} 

Note that the BookStore class only needs to describe fields directly contained in it. Sub-elements 
such as Address and Book (contained in the collection) will provide their own descriptions by 
implementing the interface. 

The FieldDescription Class 

The FieldDescription class provides the set of information needed by the API to convert between 
Java and XML representations. The FieldDescription class has the following constructors: 

FieldDescri P tion(String tagName, Class cbjectClass, String getMethod, String setMethod) ; 

FieldDescription (String tagName, Class objectClasa, string getMethod, String setMethod, 
Object contentClasses) ; 

FieldDescription (String tagName, Class objectClaes, String getMethod, String setMethod, 
Object contentClasses, Object ContantTagNames) ; 

For simple elements, the first constructor is used. When a field is represented as a Collection, 
Hashtable or an array, the second forms are usedto describe the elements in the collection. 

For the first form, the parameters are: 

• TagName - when writing this field to XML, what name should be used for the corresponding 
XML element tag. 

• ObjectClass - Specifies the Class to instantiate when construe ting* this field from XML 

• GetMethod - The name of the Java method to invoke to retrieve this field. 

• SetMethod - The name of the Java method to invoke to retrieve this method. 

The contemClass parameter is used to specify what class of object must be instantiated and 
constructed from the element. It may be any one of the following: 

• A single Class object. In this case, all elements will be represented by the same class, 

• The class may be based on element tag name. In this case, the parameter passed in is a 
Hashtable, where the keys are the element names and the values are the corresponding Class 
types. 

• The class may be based on an attribute value contained in the elements. In this case, the 
parameter is a Hashtable where they keys are specified in the form t( attrName=anrValue" and 
the values are the Class types to use. 
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A containing class must also specif/ the element names to use for each field when writing them to 
the XML document. The conrentName parameter may be any of the following: 

• The same name for all elements. In this case, pass a single String containing the name to use. 

• The name may be obtained by invoking a "get" method on the object. In this case, you must 
specify a method name preceded by an "@" (e.g. "@getMyName"). This method must take no 
parameters and return a String. 

• The name may be based on the class of object. In this case, the keys should be the Class types 
and the corresponding values should be the tag name to use. 

• Based on Hashtable keys, if collection is an instance of java.util.Hashtable. In this case, use the 
FieldDescription constructor that does not take a contentName parameter. 

In order to support inheritance, subclasses only need to define FieldDescriptions for new elements, 
and simply concatenate the FieldDescriptions of the parent class. For this purpose, the 
FieldDescription class has a concat method to make this easy. For example, the ReviewedBook 
class inherits from the Book class, so it's getFieldDescription method could be written as: 

class ReviewedBook extends Book { 

public FieldDescription!] getFieldDescriptions ( ) { 
FieldDescription [3 fda = new FieldDescription [] { 

new FieldDescription ("reviews", vector . class, "getReviews" , "eetReviews" , 
Review, class, ''reviews") 

}; 

return FieldDescription. concat { fda, super .getFieldDescriptions ( ) ); 



For the case of the book collection, we may just construct a Book object for each element if all we 
are interested in is the base class. However, if we want to construct a different type, depending on 
the attribute, we may do that as well. We can modify the contentCtass parameter to be a Hashtable, 
and specify the type based on attribute: 

Hashtable ht = new Hashtable {> ; 

ht .put ( u reviewed=yes" ReviewedBook. class J ; 

he .put { M reviewed=no" , Book. class) ; 

6d = new FieldDescription ( "books" , Vector . class, "getBooks", "setBooks", 
ht , "book" ) ; 

Now the API can determine what type of class to instantiate based on attribute. 
Attributes versus Elements 

It is up to an implementation to decide whether to use elements or attributes. For example, consider 
a User object: 

User { 

String id; 
String lastNane; 
String firstName; 
string phoneNumber 
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} 

In this object model, id, lastName.firstName and phoneNumber are considered "attributes" of User. 
In XML, this may be modeled as either: 

<user> 

<id>lO01</id> 

<lascMame>Smith</lascName> 
<f irstName>Joe</f irstName> 
< phoneNumber > ?32-222-1234< / p ho neNuir.be r > 
</user> 

or as 

<user id«" 12345" > 

<lastName>Smith</lastName> 

<f irstName>Joe</£ irstNamo 

<phoneNumber>732-222-1234</phoneNumber> 
</user> 

For the second case, rather than describing id with a FieldDescription, it would be treated as an 
attribute in the User class: 

Class user { 

String id = null; 

FieldDescription[J getFieldDeecriptions { ) { 
return new FieldDescript ion [] { 

new FieldDescription("lastName" , String ,clas$, "getLastName" , -setLasttfame" ) , 
new FieldDeecription( M firstName", String .class , "getFirstName" , setFir$tName" ) , 
new FieldDescription( "phoneNumber", String .claBs, "getNumber" , "eetNumber" ) , 

}; 

Hashtable getActributes ( J { 

Hashtable ht = new Hashtable (); 
he. put { "id", id); 
return ht; 

} 

void setAttriutes(Kaehtable ht) { 
String 6 = ht .get { n id" ) ; 
if( e != null ) this. id = new Scring(e); 

) 

} 

The XmlUtil class 

This class provides static methods that load and save Documents to and from XML streams as well 
as converting Document objects to and from specified Java classes. For the above book store 
example, the complete code needed to save the BookStore to an XML file and later restore it is as 
follows: 

// construct a book store and populate it with books- 
Bookstore bookstore = new Bookstore (~) ; 
Book book o new Book (...); 
BookStore .add( book) ; // etc. 

// turn it into a Document object and aave to an XML file 
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Document doc n XmlUtil .gee Document ( "books core" , bookstore); 
XmlUtil .writexml (doc, "books . xml" ) ; 

// later, reload the book store from XML 
Document doc = XmlUtil . readXml ( "books .xml" > ; 

Bookstore bookstore * (Bookstore) XmlUtil . getObj ect (doc, Bookstore . class) ; 
Collection books - bookstore .gecBooks U ; // do something with books 

The readXml and writeXml are used to read and write Documents to and from XML files (or more 
generally streams). The conversion from a Java object to XML is accomplished by: 

Document XmlUtil .getDocument (String dOCName, Object ob j ) ; 

As long as the top level object and contained objects implement XmlReader Writer, the whole 
collection can be handled by this call. To convert a Document to any class implementing 
XmlReader Writer, use: 

Object XmlUtil. gecObject (Document doc, Class objectClass); 

An instance of objectClass will be instantiated and queried for it's FieldDescriptions. From that 
point the API can determine how to convert all nodes that it encounters. This works recursively 
through the whole document tree. As mentioned, different object classes can be used to produce 
different results. 

Summary 

The API described here is a simple yet powerful mechanism for converting between Java and XML 
representations. It can be easily applied to any application that is written in Java and is using XML 
as an external data exchange format. The mechanism will work with any XML parser that 
implements the standard W3C Document Object model. XML representations are easily converted 
directly into the Java objects and data types used by developers within their application. 
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From: Mohler, David S (David) 
Sent; Friday, October 20, 2000 12:47 PM 
To: Walker, William J (William); Bean, Thomas J (Tom) 

Cc: Rudnick. Robert E (Rob); Potkay, Eugene (Gene); Beightol, Dean D (Dean) 

Subject: RE: patent candidate 

Tom, 

I would like to suggest a very high priority on this application. The reason for this is the 
importance in the industry with anything related to XML or its varients {UXL, VXML, etc). Further, 
XML is key to several of Avaya's "growth engine" technologies. Bill Gates recently said that 'We 
are betting a significant portion of Microsoft's future on XML" This makes sense because in its 
ultimate evolution (so far anyway) it helps MS break the strangle-hold that Sun and Linux has on 
some portions of the operating systems market that MS covets. 

During the prosecutfon of this, you may want to talk with David Volejnicek about potential 
overlap with Terry Jennings "Interactor" application (Jennings 5) and his new patent idea that he 
just talked with David about 6 weeks or so (Jennings ?). Getting the broadest possible claims 
filed in this area would be enormously commercially valuable. I am well versed in this area and 
would be glad to help in anyway that I can. Please note that this is a very fast moving area and 
that much of the prior art is only referenced on the web. I would suggest the follwong URLs for 
prior art research: 



http://www.xml.com/xml/pub 
http'7/www. hr-xml.org/ 
http://www.oasis-open,orq/cover/xm(html 

http://vyw^ ml ^Qfie PQP1 / 

http://www.xmlephant.com/ 

http://www.extensibility.com/ 

http7/www-xmitree,com/ 

http^/msdn. microsoft.com/xml/default.asD 

http://metalab.unc.edu/xml/ 

http://Www.w3.orfl/XML/Activity . html 

ht tp://Www.xmlqlobal.com/ 

http://www.perlxml.com/faQ/perl-xml"faq.html 

http://www.ozemail.com.au/-sakthi/Common/xml.html 

http^/info.dr.lucent.com/-tdi/docs/xmlaud.doc 



Regards - 

David S. Mohler 

Director of Intellectual Properly 
Avaya Inc. 

(303} 538-1033 Voice 
(303) m -6066 Fai 
dmohler@avava.cpm email 



From: Bean, Thomas J (Tom) 

Sent: Friday, October 20, 2000 7:07 AM 

To: Walker, William J (William) 

Cc: Rudnick, Robert E (Rob); Mohler, David S (Osvid) 
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Subject: RE: paten! candidate 
Bill: 

This submission is currently open and has not yet been assigned for development of an 
associated patent application. If you have any further information or details that have 
emerged since you made your original submission, please forward these to me. Like Lucent, 
Avaya's policy remains to seek appropriate protection for its intellectual property. We do 
promote use of our technology within industry standards, for example, by making the 
technology available under convenient and reasonable licensing terms. I would suggest that 
we discuss the particulars of your submission with my colleague Rob Rudnick, who has been 
supporting a number of our Avaya standards teams, to determine how we might proceed in 
Avaya's best interest. 
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Thomas J". Bean 

Corporate Counsel 

Avaya Inc. 

8 (732) 817-6164 (phone) 

9 (732) 817-4504 (fax) 
53 tj bean@avaya . com 

This message is intended only for the designated recipient(s). If you are not a designated 
recipient you may not review, copy or distribute this message. If you receive this in error, 
please notify the sender by reply e-mail and delete this message. Thank you. 



From: Walker, William J (William) 

Sent: Friday, October 20, 2000 7.37 AM 
To: Bean, Thomas J (Tom) 
Subject: FW: patent candidate 

Hello Tom: 

Joseph Opalach said you would be the person to contact about this. 
Last January, I submitted a candidate for a patent, which deals with 
a mechanism for converting Java to XML. The submission was 
accepted, but nothing further was done with it to my knowledge. 

Java and XML are very hot technologies right now, and this 
is a very useful mechanism for converting between the two. If 
nothing is going to be done regarding a patent, I would really 
like to see this submitted to Sun's Java Community for consideration 
a9 was done for their schema compiler: 

httD://lava.sun.com/aboutJava/communitvprocess/isr/jsr 031 xmld html 

I understand that there are difficulties deciding what patents to 
go after first in terms of things that can be proven easily. If this 
one is not easy to go after, I would rather see it dropped as a 
patent candidate and get it out to the Java community ASAP, in 
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one form or another. 

Thanks, 
Bill 



— Original Message — 
from: Opalach, Joseph J (Joe) 

Sent! Tuesday, September 26, 2000 12: 13 PM 

To: Walker, William J (William) 
Subject: RE: patent candidate 

Bill, 

Your work was transferred from Lucent to Avaya, 
The Avaya patent attorney is Tom Bean. 

You'll have to contact Tom for information. However, you might want to wait another 
couple of weeks, Tom is also responsible for the transfer of (intellectual property) 
information to Avaya (including, e.g., set up of computers systems, data bases, 
physical storage issues, etc.) and these next couple of weeks will be hectic for him. 

Joe 



From: Walker, William J (William) 

Sent: Tuesday, September 26, 2000 1 1:53 AM 

To: Opalach, Joseph J (Joe) 

Subject: RE: patent candidate 

Joe - Ifs been 4 months, so I just wanted to check back on this ... do you 
have any further information? 

Thanks, 
Bill Walker 

— Original Message — 
From: Opalach, Joseph J (Joe) 

Sent Monday, May 08, 2000 3: 17 PM 

To: Walker, William J (William) 

Subject: RE: patent candidate 

Bill, 

At this point, you will have to be more patient. I do not see anything 
being done for the next 4 months or so. 

With respect to timeframe and someone else coming up with it - that is 
true for every submission we have. 

It would better help me to prioritize this and accelerate it if you could 
answer the following: 

Will the work be a part of a standards contribution ? (At first pass, I don't 
believe it is but I need to be sure.) 
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How can you detect someone is using your idea - without reverse 
engineering the website (which implies you would have access to the 
code) ? 



Just fyi, in a very general sense, we prioritize submissions based on how 
easy it is to get a return on investment for the resulting patent (i e a 
licensing royalty). Patents that pertain to standards or are easy to'detect 
(without incurring the cost of reverse engineering), get to the top of the 
list faster. 



Thanks 



Joe 



From: Walker, William J (William) 

Sent: Monday, May 08, 2000 2:45 PM 
To: Opalach, Joseph J (Joe) 
Cc: Little, Cheryl (Cheryl) 
Subject RE: patent candidate 



I just wanted to check on the status of this patent submission. I 
have 

heard nothing from any attorney as of yet, and it has been over 
three months. As you know, both Java and XML are two very 
hot 

technologies today, with new designs coming up daily. My 
concern 

is that if takes much longer to move on this one, that someone 
else 

will come up with this... 

Thanks, 
Bill Walker 



BO) Waiter 

Lucent Technologies 

732817*4609 

wjw@lucent.com 



From: OpaJach, Joseph J Uoe) 

S wit: Thjrsflef. January 27, 200D 1 1:1 2 AM 

To: Welker, Willam J (WDljamJ 

Subject; RE: psicnt candtriata 



Hi Bill, 



I've looked over your submission and we will move forward with 
it. 



Most of the patent application development is contracted to 
outside attorneys, so I will get your submission rolling (so-to- 
speak) to get an outside attorney assigned. I will still be your 
contact within Lucent if you have any questions, complaints, etc. 
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The outside attorney should be in touch with you in approx 2 to 
3 months. I am going to "schedule" this submission for filing In 5 
months (the filing date in the end has to do with the current 
workload of the assigned attorney and yourself, since you will 
have to provide assistance and review the patent application so 
It could be filed sooner than 6 montns). 

Just fyi, I also have to approve the patent application, but I 
typically review it at its final stage (after you have seen it and It is 
technically correct). 

Take care, 

Joe 



From: Walker, Wflllam J {William) 

Sent: Wednesday, January 26, 2000 8:38 AM 

To: Opalach, Joseph J (Joe) 

Cc: Huang, Yean-Ming (Ming); Bauer, Eric (Eric); Chien 

Anthony H (Anthony); Walker William J (William) 
Subject: patent candidate 

Joe - 

My manager, Yean-Ming Huang asked me to forward this to you 
as 

a candidate for a patent It is a Java to Xml Conversion 

mechanism, 

This has been developed for use in IP Exchange Comm for 
database 

import/export and possibly data exchange. It is applicable to any 
Java/XML application. I have not been able to find any existing 
mechanisms that worked in this way. 

Please let me know if you need any additional information, 

Thanks, 
-Bill Walker 

«File: XmlUtil.doc» 



Bill Walker 
Lucent Technologies 
732-8174809 

wiw@fucent,com 
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BELL LABORATORIES 



siAjMfc Patent Submission IDS #121717 

Mechanism For Converting Between 
Java Classes And XML' 



Da* January 31, 2000 



From: 



Joseph J. Opalaeh 
Intellectual Proparly-Law 
H0 3K-238 (732)949-1708 



B. J. Allain: 

iTli^^ZL* 1 V 717 W3S f0fma,,y docketed t0 ««idar the patentability of 
the above-.denl.fied subject matter. W. J. Walker appears to be the originator. 

co h ntortn^ U queSti0ns re9arding 1,18 matte '. P'ease feel free to 



HO-P33A70000-JJO*. Joseph J. Opalaeh ^ 

Copy to: Corporate Counsel 

W.J.WaJker 
A. H. Chien 
Y. Huang 



Stnt: 
To: 

Sublet; 



Opalach, Jo»ph JUoel 
Thwifliy, Jjnyvr 27, 20QD 1 1:12 , 
Wilker. WiiiBi J {Williiml 
R£; prioni candidal 



Hi Bill, 



I've looked over your submission and we will move forward with 



Most of the patent application development is contracted to 
outside attorneys, so I will get your submission rolling (so-to- 
epeak) to get an outside attorney assigned. 1 will still be your 
contact within Lucent if you have any questions, complaints, etc. 



The outside attorney should be in touch with you in approx. 2 to 
3 months. I am going to "schedule" this submission for filing in 5 
months (the filing date in the end has to do with the current 
workload of the assigned attorney and yourself, since you will 
have to provide assistance and review the patent application, so 
It could be filed sooner than 6 months). 

Just fyi, I also have to approve the patent application, but I 
typically review it at its final stage (after you have seen it and It Is 
technically correct). 

Take care, 



From; Walker, William J (William) 

Sent: Wednesday, January 26, 2000 8:38 AM 

To; Opalach, Joseph J (Joe) 

Cc: Huang, Yean-Ming (Ming); Bauer, Eric (Eric); Chien 

Anthony H (Anthony); WalKer, William J (William) 
Subject: patent candidate 



My manager, Yean-Ming Huang asked me to forward this to you 
as 

a candidate for a patent. It is a Java to Xml Conversion 
mechanism. 

This has been developed for use in IP Exchange Comm for 
database 

import/export and possibly data exchange. It is applicable to any 
Java/XML application. I have not been able to find any existing 
mechanisms mat worked in this way. 

Please let me know if you need any additional information, 

Thanks, 
-Bill Walker 

«File: XmlUtil.doc» 



Bill Wtktr 

wiwi3ilijcent.com 



it. 



Joe 



Joe- 
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'A Mechanism For Converting Between 



B. J. Ailain; 

Patent submission # 121717 was formally docketed to consider the patentability of 
the above-identified subject matter. W. J. Walker appears to be the originator. 

Should you have any questions regarding the subject matter, please feel free to 
contact me. 
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A Mechanism for Converting Between 
Java Classes and XML 

Overview 

Java and XML (extensible Markup Language) technologies provide developers with the tools to 
write portable code and operate on portable data. Support for XML in the Java platform is 
increasing with the availability of standard APIs and parsers such as SAX and DOM (Document 
Object Model) While these APIs provide standard mechanisms for reading XML documents they 
work at a relatively low level. Using DOM for example, developers must have a detailed 
understanding of how to use the API to navigate nodes, elements and attributes to extract textual 
content, and then convert the text to useful program data types. This may be tedious, error prone, 
and requires the developer to work with classes outside the application domain. 

This paper describes a mechanism that allows developers to convert easily between Java and XML 
representations of data whiJe working exclusively with classes from the application domain. With 
very little work, developers can add XML support for complex hierarchies of any user defined class, 
Java primitives and wrapper classes (Integer, Boolean, Float, etc.) as well as collections of such 
objects. 

A proposal by Sun Microsystems has been drafted that deals with this topic using a different 
approach (An XML Data-Binding Facility for the Java Platform, Mark Reinhola\ Core Java 
Platform Group, 30 July 1999 - see www.jayasoft.com/xml). They propose a schema compiler that 
generates Java classes from an XML schema. The API proposed in this paper has the following 
advantages: " 

• No schema compiler is required to generate new Java classes. 

• New or existing classes can be easily annotated to work with the API. 

• The developer has full control and flexibility over how the classes get mapped to XML. Two 
totally different class implementations can work with the same XML representation in different 
ways. 

The following sections discuss how the API is used including the API class descriptions. 

An Example 

Data is described in XML in a hierarchical way by tagging elements. An XML document contains 
one single element (the document element) which may contain any number of other elements. For 
example, a XML representation of a book store may be. 

<bookStore> 

<nane>The Programmer' s Book Store</naiae> 
<address> 

<atreet>l Industrial Way</street> 
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<city>Hiddletown</city> 
<state>JJJ</state> 
<Zip>0770K/zip> 
</address> 
<books> 

<book revieved='no' > 

<title>Xau\ and Java</title> 
<author>Hiroshl Maruyama</author> 
<cost>$4 9. C0</cost:> 
</boo)c> 

<book reviewed-' yes* > 

<title>Java in a NUtshell</title> 
<author>Flannigan</author> 

<C0St>$39. 00</C03L> 

<revi«u> 

<revi€wedBy>Joe</reviewddBy> 
<rating>3 . 5</rating> 
</review> 
<reviev> 

<reviewedBy>Bob</reviewedBy> 
<r*ating>9. 5</rating> 
</review> 
</book> 
</books> 
</bookStore> 

The document contains a single element bookStore, which ha* sub-elements for name, address, and 
books, The books element contains a collection of book elements. Elements may contain one or 
more "attributes " such as the reviewed attribute of book, used to indicate whether the book has been 
reviewed or not. Books that have been reviewed contain one or more review elements. 

This data can be modeled by a set of Java classes, such as: 

class Bookstore { 
String name; 
Address address; 
vector books; 

Bookstore (String name) (...) 
void setKajne (String najne) (...) 

) 

class Book { 

String author; 
String title; 
float cost; 

BooklString title, String author) ; 
String getTitlel) (...) 
string getAuthorO [_] 

) 

class ReviewedBook extends Book { 
Vector reviews; 

void addReviev (Review review}; 

Vector getReviews () ( return reviews; ) 
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The goal of the API is to let the developer construct the data using Java only, then somehow convert 
the classes to XML and later re-construct the contents of the Java classes from the XML file. For 
example: 

Bookstore bookstore - now Bookstore {"The Programmer's Book. Store* ) ; 
Bookstore . setAddress ( new Address ( "1 Maple St.', "Middletovn' , "HJ* J ); 

Book book = new Book ("Java in a Nutshell', "Flannigan* ) ; 
Book. setCost (49. Of) ; 
Bookstore, add (book) ; 

SaveToxird (bookstore, "bookstore. xjtQ' J ; // a hypothetical method 
// later, read the contents back to Java 

Bookstore bookstore « ReadFroanXml (''bookstore . xml ' ) ; // a hypothetical oethod 
Collection books » bookstore. getBooks () ; 

The next section describes the API and mechanism used to accomplishes this 

XML to Java API 

The XmlReaderWrfterlnterface 

In order to convert user-defined types to XML, such as BookStore t Book, and Review in the above 
example, each must include some instructions about how to do the conversion. The API needs to 
know; 

• Which fields inside the Java object should be saved to XML? We may want the Java class to 
contain other fields that are used internally and should not get converted. 

• For each field that we want converted, what tag name should be used when generating the 
corresponding XML element. 

• When reading an XML file and constructing the Java objects, what classes should be instantiated 
for each element? We want to be able to support different classes and different Java 
implementations using the same XML representation. 

The Java to XML API accomplishes this by defining the XmlReaderWriter interface. Any class that 
we. wish to convert to XML or con&rruct from an XML document must implement this interface. 
The interface is defined as follows: 

interface XmlReadejfWriter ( 

rieldDescriptlanf) getFleldDescriptians {) ; 
void setAttributes(Hashtable ht) ; 
Hashtable getAttri'butes ( ) ; 

) 

The first method getFieldDescriptions is required. This allows the class to define how it should be 
converted. Typically, this will add just one line of code for all sub-elements contained by the class. 
The second two methods are optional, and are not used if the class does not use attributes as 
mentioned above. The FieldDeschption class is described in the next section, but to illustrate it's 
use, the BookStore class from the last example can add the following lines of code to implement it: 
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class Bookstore { 

public PieldDescriptionf] gstFieldDescriptions () ( 
return new FieldDeecrlptionf ] f 

new rieldDeecription("narae r , String. class, ^geU'ame', "setNaate*), 
nev FieldDescription ("address', Address . class , "getAddreea' , *setAddrese' ) 
new FieldDescraption ("books', Vector . class, s, getBooks', "setBcoks' 
Book. class, "book'), 

} ; 

) 

public void setAttributes (Hashtable ht) {;} // not used 
^ public void Hashtable ge tAt tributes (J { return null; } // not used 

Note that the BookStore class only needs to describe fields directly contained in it. Sub-elemeots 
such as Address and Book (contained in the collection) will provide their own descriptions by 
implementing the interface. 

The FiBkfOBScription Class 

The FieldDescription class provides the set of information needed by the API to convert bertween 
Java and XML representations. The FieldDescription class has the following constructors: 

FieldDescription (String tagNarce, Class objectClass, string getrtethod, String setMethod); 

FieldDescription (String tagNajne, Class objectCUsa. String getrtethod, String setKethod, 
Object contentClasses) ; 

FieldDescription (String tagKama, Class obj ectClaas, String getMethod, String settiethod 
Object contentClasses, Object ContantTagNajnes) ; 

For simple elements, the first constructor is used. When a field is represented as a Collection, 
Hashtable or an array, the second forms are used to describe the elements in the collection. 

For the first form, the parameters are: 

• TagName - when writing this field to XML, what name should be used for the corresponding 
XML element tag. 

• ObjectClass - Specifies the Class to instantiate when constructing this field from XML 

• GetMethod -Ths name of the Java method to invoke to retrieve this field. 

• SetMethod- The name of the Java method to invoke to retrieve this method. 

The contentClass parameter is used to specify what class of object must be instantiated and 
constructed from the element. It may be any one of the following: 

• A single Class object. In this case, all elements will be represented by the same class. 

• The class may be based on element tag name. In this case, the parameter passed in is a 
Hashtable, where the keys are the element names and the values are the coiresponding Class 
types. 

• The class may be based on an attribute value contained in the elements. In this case, the 
parameter is a Hashtable where they keys are specified in the form "artrName^am Value" and 
the values are the Class types to use. 
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A containing clasB must also specify the element names to use for each field when writing them to 
the XML document. The contentName parameter may be any of the following: 

• The same name for all elements. In this case, pass a single String containing the name to use. 

• The name may be obtained by invoking a "get" method on the object. In this case, you must 
specify a method name preceded by an "@" (e.g. u @getMyNamO. This method must take no 
parameters and return a String. 

• The name may be based on the class of object. In this case, the keys should be the Class types 
and the corresponding values should be the tag name to use. 

• Based on Hashtable keys, if collection is an instance of java.util.Hashtable. In this case, use the 
FieldDescription constructor that does not take a contentName parameter. 

In order to support inheritance, subclasses only need to define FieldDescriptions for new elements, 
and simply concatenate the FieldDescriptions of the parent class. For this purpose, the 
FieldDescription class has a concat method to make this easy. For example, the ReviewedBook 
class inherits from the Book class, so it's getFieldDescription method could be written as: 

class ReviewedBook extends Book { 

public FieldDescription!] getFieldDescrlptions () { 
KialdDescripcianf J fda = new FieldDescription [] { 

new FieldDedcription ("reviews' , Vector . class, ''getRevlevs' , "setReviews' , 
Review. class, ^reviews') 

li- 
re turn FieldDescription. concat { fda, super . getFi el dDes crip tion* ( ) ); 

) 

J 

For the case of the book collection, we may just construct a Book object for each element if all we 
are interested in is the base class. However, if we want to construct a different type, depending on 
the attribute, we may do that as well. We can modify the contentClass parameter to be a Ha&htable, 
and specify the type based on attribute: 

Hashtable ht - new Hashtable (); 

ht.put ("revieweoVyes' , ReviewedBook. class} ; 

ht .put C*revieved«no # , Book .class) ; 

fd » new FieldDescription ("books' , Vector , class , ^getBookV, "setBooka' , 
ht, "book'); 

Now the API can determine what type of class to instantiate based on attribute. 
Attributes versus Elements 

It is up to an implementation to decide whether to use elements or attributes. For example, consider 
a User object: 

User 1 

String id; 
String lastKame; 
String firstName; 
String phone Numb or 
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<U5er> 

<id>100Wid> 

<lasUJame>Smith</la3tKarae> 

< f 1 r 5 tNamc> Joe</ f i r a tNaae> 

<phonef^rober>732-222-1234</phoneNu«ber> 
</u3©r> 



or as 



<user id*'I2345'> 

<1 as tKajne>5mi th</l as cKama> 

<firstNaae>Joe</f ir3LKanie> 

<phoneMumbe r >7 3 2 -2 22 - 3 2 3 < < /phoneNunber > 
</user> 



Set *" deSCribme " 1 ""«•«"■** « b e freaed „ an 

Claas ueer | 

String id = null; 

FlaldDescriptionf] getFieldDescriptiona () f 
return new FieldDescription [ J ( 



); 



Kashtable getAttributes ( ) { 

Hashtable ht = new Hashtabie ( j ; 
ht. put rid', id},- 
return he; 

) 

void setAttriutes {Hashtable ht) ( 
String a - ht.get rid' ) t 
if ( 3 !- null ) this. id = new String (a); 



This class provides static methods that load and save Documents to and from XML streams as well 

l^rr 8 "T*" °, bjects ;° J and fr ° m SpeClfied Java cl&88es - For above book store 
Mows t0 ^ B00kSt0re t0 an XML file and later restore h is as 

// construct a book store and populate it with books 
Bookstore bookstore = D © w Bookstore (._) ; 
Book book » new Book („.).; 
Bookstore. add (book); // etc. 

// turn it into a Document object and save to an XML file 
Document doc = Xndutil . gatDocument ("bookstore' , booXStore); 
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XnaUtil.writeXnKdoc, "books . nul ') ; 
Document doc . XmlUtil . r.adXml ("books aim. 

^^tXrtutii.g.tDocu^nt string doa,^, Ob ject ob j); 

"VeX^ 

XmlReaderWriter, use: m 8 Document t0 class implementing 

o>3ect X^Util.oetObject, Document doc, Cla, s ob 3 actcia,,, , 

through the whole document tree ^Sotd H * J" 00 ^ This worb "cursively 
different results. ' ° ned ' d,fferent ^ cl *"« can be used to produce 

Summary 

t^.JSS:^' "* ^ *» - XML 
48 in external to. e«h»g ^taST n?SSSS ? ^ " ' m ™< » ™>« XML 

too U,e ,.v. „ bjea , md dM ^ S ™S " 
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This Page is Inserted by IFW Indexing and Scanning 
Operations and is not part of the Official Record 



Defective images within this document are accurate representations of the original 
documents submitted by the applicant. 

Defects in the images include but are not limited to the items checked: 



□ IMAGE CUT OFF AT TOP, BOTTOM OR SIDES 

□ FADED TEXT OR DRAWING 

□ BLURRED OR ILLEGIBLE TEXT OR DRAWING 

□ SKEWED/SLANTED IMAGES 

□ COLOR OR BLACK AND WHITE PHOTOGRAPHS 

□ GRAY SCALE DOCUMENTS 



□ REFERENCE(S) OR EXHIBIT(S) SUBMITTED ARE POOR QUALITY 

□ OTHER: 



IMAGES ARE BEST AVAILABLE COPY. 
As rescanning these documents will not correct the image 
problems checked, please do not report these problems to 
the IFW Image Problem Mailbox. 



BEST AVAILABLE IMAGES 




BLACK BORDERS 




LINES OR MARKS ON ORIGINAL DOCUMENT 



